XML Controls are configured in the web.config. It is possible to configure the file folders, assembly references and using statements.
Section |
Description |
/ui/using |
Defines using statements that are included in the interim C# file. |
/ui/references |
Defines the assemblies to reference in the compilation step. |
/controlSources |
Defines the file directories to look for XML Controls and assemblies where web controls may appear. |
An entry in the control sources section can have the following attributes:
Attribute |
Description |
Mode |
If mode is “off”, the entry is ignored. |
Namespace |
Defines the namespace of the webcontrols in this source. |
Folder |
The file directory. |
Assembly |
An assembly that contains webcontrols. |
Deep |
Defines that subfolders should be included, if the source is a directory. |
Prefix |
If specified, controls in the XML Control must have this namespace. |
Control sources are searched in the sequence that is specified in the web.config. If two XML Controls have the same name, the control that occurs in the first control source is used and the other ignored. This allows XML Controls to be overridden, simply by insert the new control in a control source that is placed first.
2.1. XML Control Configuration example
:
<controlSources>
<source mode="on" namespace="Sitecore.Web.UI.XmlControls" folder="/sitecore/shell/override" deep="true"/>
<source mode="on" namespace="myNameSpace" folder="/sitecore modules/controls" deep="true"/>
:
</controlSources>
:
<!-- UI -->
<ui>
<usings>
<using>System.Collections</using>
<using>System.Reflection</using>
:
</usings>
<references>
<reference>System.dll</reference>
<reference>System.Data.dll</reference>
:
</references>
:
</ui>